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SUBJECT! A generalized ready message program 


Attached to this MTB is the description of a generalized 
reacy message command. It is 4 modification of the suthor 
maintained general_ready command. This new version is capable of 
printing both incremental and totai values in the same ready 
message laithough the totai vaiues are per-process fotais only)e 
The date and time can be printed in a number of different formats 
and new 6189 Multics quantifies such as memory units, level 
numbers, etcse can also be printed. 


The new version of general _ready described in the attached 
MPM ¢ike descriotion is operstional, a version is avaiiabile in 
>udc>ROMS>pubiic>general_ready. 


One addition that has already been suggested is the 
replacement of the print messages faciilty with the more genera! 
capebility of specifying a command tine to be executed whenever 
the ready message procedure Is invoked. 


Acditiona!l comments or suggestions should be directed to Jay 
Goloman MIT room 39-411 or to Goloman.ROMS on the MIT Multics. 


DEERE CRED ADR ASAE ASE A AED CENCE EE MIR REELS EY 


Reema OEP kc AN AR OR AIOE NERS eee 


Multics Project internal working documentations Not to be 
reproduced or distributed outsice the Multics Project. 


heat oe - MTB - 113 

H 3 

! general_ready ! MULTICS PROGRAMERS*® MANUAL 
j 


perenne IA eS Sat MARR LT A AN pleat TS eS 


Authore-Maintained Library 
. Jay Golcman 
39-411 

Ext. 324107 

08/11/74 


Name: generai_ready, gr 


general ready is a command which allows the user fo set up 
a ready message containing specific vaiues in a user specified 
format. The program is designec to allow an almost arbitrary 
format at no additional cost (relative to the system°s ready 
procecure) other than the cost associated with the general_reaay 
command which sets up the readgy message. OGnce a ready messace 
has been specified, the ready_on, ready, and ready_off commands 
wili centro! the printing of the ready message in the normal 
manrer o 


general_ready builds up an ioa_ controi string from the 
order of the keywords passec to ite The keywords specify which 
values to output in the ready message. Virtuai cpu usage, reat 
cpu usage, and agollar cost can be printed. Both incremental 
usage {usage accrued since the tlast ready message printec by 
general_ready) and total usage (usage accrued during this 
process) can be printeaq in the same ready message with the 
precision of the output (the number of cecimal piaces to the 
right cf the decimai point) specified by the user. 


Usace 


general_ready -control options- -prefix options- 
-formaft options- 


Tre prefix options affect the format of the ready message but ao 
not specify the contents (the values oprinted) of the ready 
message. The format options specify both the contents and the 
format of the reacy message. The control options do not affect 
the format of the ready message, but instead contro! how the. 
reacy message and other facilities provided by general _ready are 
used. The prefix options must occur before any format options; 
while the control] options may appear anywhere on the command 
iine. 


Earmat Options 


The format ana content of the ready message is controited by 
format optionse These options includet keywords which idaentify 
values to be included in the ready message$ optional arguments 
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following these keywords which cortroi the number of digits after 
the decimal point in numeric values; and Jiterai character 
Strings which are insertea in the ready message. Tne format 
options are combined in the order of their appearance in the 
general_ready command to form an tioa_ control string wrich 
controis the format of tne ready sessage. 


Six types of values may te used in a ready message? 
processor usage vaiues (virtual and real cpu seconds)$ memory 
usase values (memory units); paging operations (both bulk store 
reacs and demand page fauits) 35 usage cost values (dotiar 
charges)$3; command processor fevel numbers}; and date/time vatues 
(date, time of days day of the week, etc). Both totai usage 
values (total usage accrued during this process) and incremental 
usace values {usage accrued since the last ready message printed 
by general_ready) can be output in tne same ready message. The 
values are selected for use in the ready message by the format 
keyworcs which are given in the commande. The format keywords are 
listed below by type. . 


1) processor usage values are selected from the folloning 
key wordS e These keywords can be followed by an optional 
ergument, a single numeric digit from 4 to 9, to indicate the 
rumber of digits which should appear to the right of the 
cecimal point in the number which is output. The default is 3 
cigits. The output format of the vaiue can be described by 
the ioa_ control string “ ~.nf" where pn is 3 by default. 


er] 
-rcpul incremental reat cpu vatue 


-rt 
-rcput tfotatit reajl cpu vaiue 


“vi 
-yvcpui incremental virtuai cpu vatiue 


-vt 
-vcoput total virtual cpu vaiue 


2) memory usage vatues are selected by the following keywords. 
These keywords are used in the same manner as the keywords for 
erocessor usage vaiues above. 


-memroryi 


-mu i 
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3) 


4) 


5) 


omemi incremental memory units 


=meroryt 
me mt 
-mut tota] memory units 


usage cost values are selected by the following keywords. 
These keywords are used in the same manner as the keywords for 
processor usage values with the following differences. The 
cefault number of digits foilowing the decimal point is 2. 
The output format of the value can be described by fhe loa_ 
contro! string * $7 .nf" where pn is 2 by default. 


-doliarsi 
-$i incremental cost charges 


-dollarst 
-$f total cost charges 


paging vaiues are selected from the follwing keywords. These 
keywords are output by the ioa_ contro! string ™ “dt7d", where 
the first number is the number of bulk store pages read 
(formerly the number of pre-pages) and fhe second is the 
rumber of demand page faults. 


-pagesi 
-pqgi incremental paging vaiues 


-pagestf 
-pgt total paging vaitues 


command processor jievel numbers ere selected by the following 


keyword. This keyword incicates that fhe command processor 
end stack frame level numbers should be inciuded in the ready 
message. No optional argument may be used to contro! the 


number of digits. The ftevel numbers are output by the ioa_ 
contro! string “"“a", but the printed format can be described 
by “ level “dy d™ where the first number is the number of 
command processor invocations and the second is the stack 
frame depth of the ready message procedures stack frame. If 
the command processor ftevel is is the printed format is the 
null stringe ; 


-ileve] 
“iv command processor jievel numbers 
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6) cate values are selected by fhe follcwing keywordse These 
values can be described by the loa control string “ “a™“ except 
for the e-min keyword which uses the ioa contro! string "a" 
(without a leading space). No optional argument may be used 
to controt the number of digits. 


-ct date ana time (mm/ac/yy hhnmmem 2ZZ www) 
-date 8 character date (mm/dd/yy) 
“hour 2 aigift nour (hh) 


-minute 
-min 2 digit minute (mm) 


-~time | 
-tm 6 digit time of day (hhaemem) 


“dow 3 character Gay of week (nww) 


-7one 3 character time zone (zzz) 


Note that aii vatues except for the number of minutes 
f-eminute) are preceded by a space and none of the vatues are 
suffixeac by a spaceée Any non-keyword argument (other than a 
Sincle numeric digit following a fioating point or dollar 
keyword) Is assumed to be a jiitferal string which is inserted in 
loa. contro! string belng bulit by general_ready. Refer to the 
examples below. 


Control Options 


The fotilowing contro! options affect the operation of 
general_readys but do not change the format of ready messaces. 


-set causes general_ready to establish itself as the current 
ready message procedure. The command processor will 
then call general_ready to print a ready message after 
each command line is compiete. In addition, the system 
commands, ready, ready_on, and ready_off, wiil affect 
the operation of general_ready. 


-reset causes general_ready to make the system ready proc the 
-rs current ready message procedure, and to reset any timer 
alarms which were established to catch shift changes. 
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-prinf messages 

-prmesg when used wifh the -set control option, causes 
general_ready to call the print messages {pom) procram 
before printing the ready messageo This ailows the 
user to defer messages queued »by the 
ipc_message facility untifi each command line has 
completed executions Any queued messages are typed 
just before the ready tine, even if the ready_off 
command has been calied to turn off ready messages. 


The eset and e-reset control options are mutually exclusive. | 
A general_ready command which includes -set does not print a 
reatcy message. Instead, it saves the ica_ control string built 
from the format options in the command, and uses this loa, string 
to control the format of ready esessages printed when command 
iines complete execution or when a ready command is issuedo 


A general_ready command which includes -reset prints a 
Sincie ready message, oniy if format options appear in the 
command with the -reset option. Otherwise, no ready message is 
printed. Seg 


If neither -set nor “reset is given, then general_ready 
prints one ready message according to the format options given in 
the commando 


Prefix Options 


There are two prefix options, These opfions must occur orior 
to any of the format options described above. The two prefix 
options allow the user to overrice the default formats for the 
contents of the ready messase, they are? 


-string allows the user to specify the character string at 

-s the beginning of the ready message. The argument 
following this option Is used instead of “r “ at 
the beginning of the ready message. Since if is 
put into the jisa_ control strings, “"“/", “"R" and 
“~B" may be used to cause new tines, red ribbon 
shifts ana black ribbon shifts, respectively. 


-contrat alfows the user to specify the entire ioa_ control 
-ct} String used to format the ready messages The 
String will be passed to ioa_$nni without change 
so It musf contain specifications for each of the 
various vaiues to be tIncludea In the ready 
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message. The ios. control string formats for the 
various values which can be inserted into the 
ready message are given above for each type of 
value. This argument overrides any format control 
options which would normatiy affect the format of 
tne ready messagee However, format keywords must 
still be specified to indicate which values are to 
be output and the order In which these values 
correspond with the ioa_ control characters in the 
control string. 


Exasoies 


The following examples Lliiustrete some of general_ready’s 
facilities: 


or -string READY -date ~xTIME -time ~xVCPU -vi evcput -set 
The above command iine establishes generai_ready as the current 
reacy procedure since the -set keyword appeared. Eacr ready 
message would have the formati 


READY 01/15/74 TIME 1234.3 VCPU 36456 232349 


{if the -set keyword haa not appeared, a single reacGy message 
having the above format would be printed. 


The ioa_ control string which general_ready uses to generate the 
above ready message would be? 


"READY ~a7~xTIME ~a~xVCPU 7~.3f ~.3f72/" 
The command jiines’ 


gr ©-s READY e-date -hour & emin ~xVCPUI -vcpul ~xVCPLT 
-vceput 2 


woula result in a single ready message of the caput 
READY 01/15/74 09246 VCPUI 2.345 VCPUT 34.21 
using the ioa_ control errings 
“READY “a ~ai7~a~xVCPUI ~e3f~xVCPUT ~.2f72/" 
The above ready message could have been specified by the command 
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line: 


gr -ctl “READY 7a 7as7a VCPUL 7~.3f VCPUT ~.2f72/" <-date 


“hour -min -vcpui evcput 


Note 


The totai vaiues printed by generai_ready 
totals ontiye Since the system coes not provide 
for processes otfher than the current process, 
not obtain information about usage in prior 
general_ready is invoked for the first time 


doltar cost of ali usage (in that process) up to 


time is computed at the rates then in effect. 


are per-process 

usage information 
general_ready can 
processese khen 
in a process, fhe 
that point in 
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